home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / tbag11.zip / TBAG.DOC < prev    next >
Text File  |  1990-03-03  |  15KB  |  494 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 TBAG.EXE
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                            Author : Steve Thompson
  21.                            GT Net Address : 302/006
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                           Version 1.1 - 3rd March 1990
  40.  
  41.  
  42.  
  43.  
  44.     DISCLAIMER / COPYRIGHT 
  45.  
  46.     This program comes with no warranty, either express or implied.
  47.     Use it at your own risk.
  48.  
  49.     These programs and documentation ARE NOT placed in the public domain
  50.     and the copyright remains with the author.   However, please feel
  51.     free to share copies of these programs and documentation with anyone
  52.     provided that :
  53.  
  54.     1) the EXE and DOC files are unmodified and distributed together and
  55.  
  56.     2) no fee is charged for copying or distribution.
  57.  
  58.  
  59.  
  60.     If you find this program useful, there's no need to send money, just
  61.     leave me a message as follows :
  62.  
  63.     from the GT network, "Steve Thompson" or "Sysop" at 302/006,
  64.  
  65.  
  66.     On the other hand, if you're absolutely overwhelmed with
  67.     generosity, you can send donations (in Australian dollars) to :
  68.  
  69.     Steve Thompson
  70.     PO Box E64
  71.     Parramatta East  NSW  2150
  72.     Australia
  73.  
  74.  
  75.  
  76.    PURPOSE
  77.  
  78.    Tbag is designed to give the individual sysop information about and
  79.    the control over their own echomail routings.   Using Tbag reports,
  80.    you can see where your echomail Q or E bags come from and each system
  81.    that they pass through.   You can also see if upstream nodes are
  82.    crashable, what speed modem they use, in which city they're located
  83.    and if there are any warnings such as 'temp_down'.   The Tbag report
  84.    will also show which day the Tbag passed through each system so that
  85.    you can spot any delays in the mail.   From this, you can tell if
  86.    there is a more efficient or cost-effective routing for any and all
  87.    conferences. You also see the upstream routing of B bags in each
  88.    conference to check that it's the reverse of downstream routing.
  89.  
  90.    Each system that sponsors one or more conferences, will generate a T
  91.    bag for each sponsored conference automatically twice a month, on the
  92.    1st and the 16th.   T bags may also be generated manually by the
  93.    sponsor.
  94.  
  95.    As it passes down the chain, each system will unpack the T bag,
  96.    append their own routing information and then repack all of the T
  97.    bags for each of their downstream nodes.   While the T bag is
  98.    unpacked, it is distributed to the corresponding message area on your
  99.    system.
  100.  
  101.  
  102.    Here's a sample of the report you should get in each conference for
  103.    which the sponsor is generating T bags (and all intermediate systems
  104.    are running Tbag).
  105.  
  106.  
  107.    Echomail routing report generated by TBAG
  108.  
  109.    E10/053  Oz Companions
  110.  
  111.    302/001 96 C Sydney (Sponsor) E1136
  112.       ║
  113.       ╟─── 302/003 96 C T Sydney
  114.       ║
  115.    302/000 96 C Sydney E1137   302/001
  116.       ║
  117.       ╟─── 004/005 96 C   Dallas
  118.       ╟─── 302/016 24 C T Sydney
  119.       ╟─── 302/017 24     Sydney
  120.       ╟─── 307/001 96 C   Brisbane
  121.       ║
  122.    302/006 24 C Sydney E1137   302/000
  123.       ║
  124.       ╟─── 302/011 24   T Sydney
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.    SETTING UP
  132.  
  133.    Using Tbag depends upon a couple of things.
  134.  
  135.    1 - You must be using GT15,
  136.  
  137.    2 - You must be receiving and sending G bags,
  138.  
  139.    3 - You must be using pkzip for G bags,
  140.        (doesn't matter what you use for B, E or Q bags)
  141.  
  142.  
  143.    Place TBAG.EXE anywhere in your Dos path.
  144.  
  145.    Next, make a subdirectory \TBAGOUT on you mail drive.   The mail
  146.    drive is the one which has the \MAILOUT \MAILIN and \MAILWORK
  147.    subdirectories.
  148.  
  149.    In \TBAGOUT, make up a text file called TBAG.CTL
  150.    In this file list each system which is downstream from you and that
  151.    you connect with and THAT IS RUNNING TBAG.   See the list of
  152.    questions below.
  153.  
  154.    The net/node number must start in column 1.
  155.    You can just copy lines out of the nodelist like so :
  156.  
  157.    302/000 02-804-6412  96 Sydney     *Poet's Dilemma       John Della-Torre
  158.    302/011 02-455-1806  24 Sydney     *Home Computing       David Woodbridge
  159.    302/016 02-671-5538  24 Sydney     *Koala Country        Warren Leadbeatter
  160.  
  161.  
  162.  
  163.      * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  164.      *                                                               *
  165.      *                  I M P O R T A N T   N O T E                  *
  166.      *                                                               *
  167.      *   DO NOT ADD TO THIS FILE ANY DOWNSTREAM SYSTEM IF YOU        *
  168.      *   ARE NOT ABSOLUTELY CERTAIN THAT THEY ARE RUNNING TBAG.      *
  169.      *                                                               *
  170.      *   If they're not running Tbag, then the T bags that you       *
  171.      *   send them will be unpacked by Mdist and they will build     *
  172.      *   up in their mailout and mailin subdirectories, eventually   *
  173.      *   bringing that downstream system to a grinding halt.         *
  174.      *                                                               *
  175.      *   No way around this one.  Mdist unpacks everything in a      *
  176.      *   G bag, not just Q, E and B bags.                            *
  177.      *                                                               *
  178.      *                 You have been warned!                         *
  179.      *                                                               *
  180.      * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.    Here is an example of a few Tbag.ctl files.  Let's assume that only
  188.    four systems are running Tbag.
  189.  
  190.                                                 tbag.ctl
  191.                         302/000 sponsor         302/006
  192.                            
  193.                           │ │
  194.             ──────────────┘ │
  195.     Other                   │
  196.    systems                                     tbag.ctl
  197.     not                  302/006                302/000
  198.    running                                   302/011
  199.     tbag    ──────────────┘ │ │                 302/016
  200.                             │ │
  201.                             │ │
  202.                   ┌─────────┘ └───────────┐
  203.                   │                       │
  204.                                                          tbag.ctl
  205.                302/011                 302/016 sponsor    302/006
  206.                No tbag.ctl
  207.  
  208.  
  209.  
  210.    Ask yourself these questions before you add any system to the
  211.    TBAG.CTL file :
  212.  
  213.    1 - Do I have a direct connect with this system?
  214.  
  215.    2 - Am I passing G bags to this system?
  216.  
  217.    3 - Are these G bags 'zipped'?
  218.  
  219.    4 - Am I passing E or Q bags DOWNSTREAM in these G bags?
  220.  
  221.    5 - Is the other system running Tbag?   (Ask the sysop, don't assume)
  222.  
  223.  
  224.    If the answer to all of these questions is Yes, then you can add that
  225.    system to your TBAG.CTL file.
  226.  
  227.    If the answer to ANY question is No, don't.
  228.  
  229.  
  230.  
  231.  
  232.    If you sponsor one or more conferences, add the following to the
  233.    start of your netmail.bat file so that it runs once per day, before
  234.    your first Mbag in mail time :
  235.  
  236.    TBAG GEN
  237.  
  238.  
  239.    If you pass conferences to downstream nodes, put the following AFTER
  240.    EVERY run of Mbag :
  241.  
  242.    TBAG BAG
  243.  
  244.  
  245.    Everyone, run the following BEFORE EVERY run of Mdist :
  246.  
  247.    TBAG DIST
  248.  
  249.  
  250.  
  251.    This means that you should modify all netmail batch files, such as :
  252.  
  253.    NETMAIL.BAT
  254.    G_UNPAK.BAT
  255.    GTCRASH.BAT
  256.    CRASHOUT.BAT
  257.    etc.
  258.  
  259.    If you don't run TBAG BAG after every MBAG and TBAG DIST before every
  260.    MDIST, you'll lose T bags.
  261.  
  262.    Note that you should put TBAG in the batch file so that it runs on
  263.    your mail drive.
  264.  
  265.  
  266.    In summary,
  267.    If you sponsor conferences, you should run :
  268.  
  269.    TBAG GEN     once a day, at the start of netmail
  270.    TBAG BAG     after every mbag
  271.    TBAG DIST    before every mdist
  272.  
  273.  
  274.    If you pass conferences downstream but don't sponsor any, run :
  275.  
  276.    TBAG BAG     after every mbag
  277.    TBAG DIST    before every mdist
  278.  
  279.  
  280.    If you don't sponsor and don't pass downstream, just run :
  281.  
  282.    TBAG DIST    before every mdist
  283.  
  284.  
  285.  
  286.    By the way, here's how I have things set up on my system.   For
  287.    clarity, I've taken out all the other miscellaneous programs and just
  288.    shown Tbag and the mail programs.
  289.  
  290.    netmail.bat   (runs at 4:30am)
  291.      D:                          <--- mail drive
  292.      CD \
  293.      TBAG GEN
  294.      MBAG
  295.      TBAG BAG
  296.      MDRIV        --------------->  g_unpak.bat   (after each connect)
  297.      TBAG DIST                      TBAG DIST
  298.      MDIST                          MDIST /G
  299.                                     MBAG /G
  300.                                     TBAG BAG
  301.  
  302.  
  303.  
  304.  
  305.  
  306.    Next comes your routing file(s).
  307.  
  308.    . If all of your ROUTING INSTRUCTIONS and MESSAGE DISTRIBUTION are in
  309.      ROUTING.BBS, do nothing
  310.  
  311.    . If your ROUTING INSTRUCTIONS and MESSAGE DISTRIBUTION are together
  312.      but not in ROUTING.BBS, add something like  /R:MYROUT.BBS to the
  313.      Tbag command line.   In this case, all of the ROUTING INSTRUCTIONS
  314.      and MESSAGE DISTRIBUTION would be in MYROUT.BBS
  315.  
  316.    . If your ROUTING INSTRUCTIONS and MESSAGE DISTRIBUTION are in
  317.      different files, add something like  /R:MYROUT.BBS /M:MYDIST.BBS to
  318.      the Tbag command line.   In this case, all of the ROUTING
  319.      INSTRUCTIONS would be in MYROUT.BBS and all of the MESSAGE
  320.      DISTRIBUTION would be in MYDIST.BBS
  321.  
  322.      For example,
  323.  
  324.      TBAG GEN /R:MYROUT.BBS /M:MYDIST.BBS
  325.      TBAG BAG /R:MYROUT.BBS /M:MYDIST.BBS
  326.      TBAG DIST /R:MYROUT.BBS /M:MYDIST.BBS
  327.  
  328.    Make sure that you add these (if needed) to all occurances of TBAG in
  329.    every batch file.
  330.  
  331.    The GEN, BAG or DIST parameter must be first on the command line.
  332.    All other parameters may be in any order.
  333.  
  334.  
  335.  
  336.    Removing Extended Graphics Characters
  337.  
  338.    This is for those who have printers or speech synthesisers that don't
  339.    handle extended characters too well.   Add XOFF to the Tbag command
  340.    line.  This will convert any extended graphics characters to
  341.    printable characters before distributing tbags to message areas.   It
  342.    doesn't affect the downstream T bag.
  343.    It's only necessary on the GEN or DIST command lines, like so :
  344.  
  345.    TBAG GEN XOFF
  346.    TBAG DIST XOFF
  347.  
  348.  
  349.  
  350.    Once you're set for Tbagging, ask the sysop(s) of the upstream
  351.    system(s) to add you to his/her/their TBAG.CTL file(s).   Now sit
  352.    back and wait for T bags to come your way.
  353.  
  354.  
  355.  
  356.  
  357.  
  358.    REPORTS
  359.  
  360.    Tbag will distribute its report for each conference to the
  361.    corresponding message area on your system.   If there are any
  362.    conferences that are 'skipped' in your message distribution, the Tbag
  363.    report will be distributed to your first netmail message area.
  364.  
  365.    Here is a sample of a Tbag report and a brief explanation of a couple
  366.    of the fields :
  367.  
  368.  
  369.    Echomail routing report generated by TBAG
  370.  
  371.    E10/053  Oz Companions
  372.  
  373.    302/001 96 C Sydney (Sponsor) E1136
  374.       ║
  375.       ╟─── 302/003 96 C T Sydney
  376.       ║
  377.    302/000 96 C Sydney E1137   302/001
  378.       ║
  379.       ╟─── 004/005 96 C   Dallas
  380.       ╟─── 302/006 24 C T Sydney
  381.       ╟─── 302/016 24 C T Sydney
  382.       ╟─── 302/017 24     Sydney      **TEMP_DOWN**
  383.       ╟─── 307/001 96 C   Brisbane
  384.  
  385.  
  386.    C  means that the system is crashable (from the nodelist)
  387.  
  388.    T  means that T bags are being sent to that downstream node.  This is
  389.       no guarantee that the downstream nodes is actually running Tbag.
  390.       Check with the sysop before sending T bags.
  391.  
  392.     302/001  means that 302/000 is sending upstream B bags in this
  393.               conference to 302/001.   This gives you a method of making
  394.               sure that upstream routing is a reverse of downstream
  395.               routing.
  396.  
  397.    **  Any warnings in the nodelist against downstream nodes (such as
  398.        temp_down) will also be shown.
  399.  
  400.  
  401.  
  402.    Note that T bags piggyback on G bags.   The netmail software (Mbag,
  403.    Mdriv and Mdist) doesn't know anything about T bags.   This means
  404.    that you should not change the message header of a Tbag report to
  405.    'unbagged' in the expectation that it will continue downstream as a T
  406.    bag.   It will just be bagged like the normal message file that it
  407.    now is and will handled like any other message by the mail software.
  408.  
  409.  
  410.  
  411.  
  412.    MANUAL GENERATION OF T BAGS
  413.  
  414.    Tbag will automatically generate T bags for each conference on the
  415.    1st and 16th days of each month.
  416.  
  417.    If, on any other day of the month, you (the sponsor) want to manually
  418.    generate a T bag for one conference, enter a message in that
  419.    conference, addressed to 'Tbag Gen'.
  420.  
  421.    If, on any other day of the month, you (the sponsor) want to manually
  422.    generate T bags for all sponsored conferences, enter a message
  423.    addressed to 'Tbag Gen' in the first netmail area.
  424.  
  425.    This message may be marked private but don't mark it received or
  426.    bagged.   Tbag will take care of that when it runs.   The subject and
  427.    text of the message are not important in this release.
  428.  
  429.    If you're not the sponsor of a particular conference, don't enter a
  430.    message to Tbag Gen.   Only the sponsor of a conference may do so.
  431.    If you're not the sponsor, the message will just be bagged like any
  432.    other message and be sent on its way around the network.
  433.  
  434.  
  435.  
  436.    PROGRAM LIMITS
  437.  
  438.    At present, the limits of Tbag are :
  439.  
  440.     300 conferences
  441.     100 downstream connects
  442.    6000 bytes in gconsol.ctl
  443.  
  444.    If any of these is insufficient, please let me know.
  445.  
  446.  
  447.  
  448.  
  449.    Appendix 1
  450.  
  451.    Acknowledgments
  452.  
  453.    Thanks to Bob Camp for his Turbo Pascal translation of the Toolkit.
  454.  
  455.  
  456.  
  457.  
  458.    Program History
  459.  
  460.    17-Feb-90   version 1.0  First release
  461.  
  462.    03-Mar-90   version 1.1  Corrected a bug in the calculation of the
  463.                             EchoDay.
  464.  
  465.  
  466.  
  467.  
  468.  
  469.    Improvements to come; please feel free to make suggestions :
  470.  
  471.    1 - Improved support for $ include routing files (if anyone finds it
  472.        necessary.
  473.  
  474.    2 - Remote turning on/off of Tbags from the upstream connect.  Much
  475.        like the .QM and .QG messages.
  476.  
  477.    3 - When a Tbag reaches the end of a chain, automatically send the
  478.        report back to the sponsor.   Have to be careful with this one
  479.        that it doesn't cause an overload to the netmail system.
  480.  
  481.        (ps, been thinking about this one.  Can't think of any reliable
  482.        way to do it without overloading netmail.  Consider any of the
  483.        popular conferences; we could end up with over 200 netmail
  484.        messages heading back to the sponsor.) Anyhow, this program was
  485.        originally intended to allow Subscribing sysops to improve echo
  486.        routings.
  487.  
  488.    4 - A companion to allow sponsors to generate a routing map of their
  489.        conferences.   Only useful if 3 goes ahead.
  490.  
  491.  
  492.     
  493.  
  494.